home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / gllinestipple.z / gllinestipple
Encoding:
Text File  |  2001-04-17  |  5.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee - specify the line stipple pattern
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee( GLint _f_a_c_t_o_r,
  14.                          GLushort _p_a_t_t_e_r_n )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _f_a_c_t_o_r   Specifies a multiplier for each bit in the line stipple pattern.
  19.               If _f_a_c_t_o_r is 3, for example, each bit in the pattern is used
  20.               three times before the next bit in the pattern is used.  _f_a_c_t_o_r
  21.               is clamped to the range [1, 256] and defaults to 1.
  22.  
  23.      _p_a_t_t_e_r_n  Specifies a 16-bit integer whose bit pattern determines which
  24.               fragments of a line will be drawn when the line is rasterized.
  25.               Bit zero is used first; the default pattern is all 1's.
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      Line stippling masks out certain fragments produced by rasterization;
  29.      those fragments will not be drawn.  The masking is achieved by using
  30.      three parameters:  the 16-bit line stipple pattern _p_a_t_t_e_r_n, the repeat
  31.      count _f_a_c_t_o_r, and an integer stipple counter s.
  32.  
  33.      Counter s is reset to 0 whenever ggggllllBBBBeeeeggggiiiinnnn is called, and before each line
  34.      segment of a ggggllllBBBBeeeeggggiiiinnnn(GGGGLLLL____LLLLIIIINNNNEEEESSSS)/ggggllllEEEEnnnndddd sequence is generated.  It is
  35.      incremented after each fragment of a unit width aliased line segment is
  36.      generated, or after each i fragments of an i width line segment are
  37.      generated.  The i fragments associated with count s are masked out if
  38.  
  39.                          _p_a_t_t_e_r_n bit (s / factor) mod 16
  40.  
  41.      is 0, otherwise these fragments are sent to the frame buffer.  Bit zero
  42.      of _p_a_t_t_e_r_n is the least significant bit.
  43.  
  44.      Antialiased lines are treated as a sequence of 1xwidth rectangles for
  45.      purposes of stippling.  Whether rectagle s is rasterized or not depends
  46.      on the fragment rule described for aliased lines, counting rectangles
  47.      rather than groups of fragments.
  48.  
  49.      To enable and disable line stippling, call ggggllllEEEEnnnnaaaabbbblllleeee and ggggllllDDDDiiiissssaaaabbbblllleeee with
  50.      argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTIIIIPPPPPPPPLLLLEEEE.  When enabled, the line stipple pattern is
  51.      applied as described above.  When disabled, it is as if the pattern were
  52.      all 1's.  Initially, line stippling is disabled.
  53.  
  54. EEEERRRRRRRROOOORRRRSSSS
  55.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee is executed between
  56.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ggggllllLLLLiiiinnnneeeeSSSSttttiiiipppppppplllleeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  75.      ggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTIIIIPPPPPPPPLLLLEEEE____PPPPAAAATTTTTTTTEEEERRRRNNNN
  76.      ggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTIIIIPPPPPPPPLLLLEEEE____RRRREEEEPPPPEEEEAAAATTTT
  77.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTIIIIPPPPPPPPLLLLEEEE
  78.  
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      ggggllllLLLLiiiinnnneeeeWWWWiiiiddddtttthhhh, ggggllllPPPPoooollllyyyyggggoooonnnnSSSSttttiiiipppppppplllleeee
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.